Summary

Two coordinated changes that share a goal: give SQLRite a public face that actually matches what the engine does today.

1. New website under web/ — a Next.js 15 + Tailwind v4 site, faithful to the Claude Design prototype but with content driven from a typed config that mirrors the canonical docs. Two pages, eleven sections, no client-side chart library, deploys to Vercel out of the box.

2. Repo doc sweep — docs/roadmap.md, docs/supported-sql.md, and docs/_index.md had drifted behind nine minor releases of actual SQL-surface work. Promoted the v0.2.0 → v0.9.1 wave from "Possible extras" into a real Phase 9 (sub-phases 9a–9i) and added Phase 10 (benchmarks). Same reality now reflects on both the website and on main.

Closes SQLR-1.

What's on the site

Landing (/)

Docs (/docs)

Sticky sidebar nav + on-page TOC. New sections for JOINs, GROUP BY & aggregates, ALTER / DROP / VACUUM, prepared statements, PRAGMA, vector search, full-text search, MCP server. The "Supported SQL" summary at the bottom now lists JOINs, aggregates, predicates, prepared statements, pragmas as their own bullets.

Benchmarks visualization

The marquee piece — designed for the dark-editorial / terminal vibe rather than reaching for a chart library.

• Three headline stats with big mono numbers in oklch accent: ~50× HNSW vs brute-force, 1.6–1.9× read-path gap vs SQLite, 608 µs hybrid retrieval at 1k docs.
• Four chart groups, each in a bordered card. Each row's bars are sized relative to the slowest in that row — so the brute-force scan is a full-width bar next to a tiny HNSW sliver (the marquee story), and DuckDB gets clamped to 1.5% min on aggregates so the µs label is still readable.
• Engineering debts table publishes SQLR-18 / 19 / 20 / 21 honestly with root-cause sketches.
• Methodology footer with date, host (Apple M1 Pro), commit short SHA, and links back to docs/benchmarks.md + the raw JSON envelope.

Update path on the next pinned-host run: edit RUN_META.date / commit / sourcePath and any affected median_ns + label fields in web/src/lib/benchmarks.ts. The visualization scales itself — no chart-library upgrade dance.

Doc sweep

docs/roadmap.md

Promoted Phase 9 (v0.2.0 → v0.9.1) and Phase 10 (benchmarks) into the document. Each sub-phase points at its release and SQLR ticket:

The "Possible extras" tail block now lists only what's actually open: subqueries, CTEs, HAVING, CASE, BETWEEN, GLOB / REGEXP, OFFSET, multi-column ORDER BY, MVCC, savepoints, more pragmas, etc.

docs/supported-sql.md

The body was correct; the "Not yet supported" section had been self-contradicting (claiming GROUP BY / aggregates / LIKE / IN / ALTER / DROP / VACUUM weren't supported while the body documented them in detail). Pruned the now-stale entries; left HAVING, BETWEEN, GLOB / REGEXP, GROUP_CONCAT, named placeholders, MVCC, etc.

docs/_index.md

"Project state" section gained Phase 9 + Phase 10 lines so a first-time reader sees them at a glance.

Stack notes

• Next.js 15.5.18 (pinned) + React 19 + TypeScript (strict) + Tailwind v4 (CSS-first @theme in src/app/globals.css) + shadcn/ui infrastructure (components.json + cn helper).
• next/font for Inter + JetBrains Mono.
• "use client" only on the three components that need state (terminal, install-bar, sdk-showcase); everything else is RSC.
• SQL highlighter is a tokenizer returning React nodes — no dangerouslySetInnerHTML anywhere.
• Single source of truth for every URL and version string lives in web/src/lib/site.ts.

Test plan

• cd web && npm install
• npm run typecheck — clean
• npm run lint — no warnings or errors
• npm run build — 5 static pages, 3.9 kB / 110 kB First Load JS landing
• Render-test against dev server: every section heading, version string, social URL, eyebrow tag, bar width, benchmark stat verified via curl + grep
• No dangerouslySetInnerHTML in the tree (code-reviewer-confirmed)
• Visual smoke-check on Vercel preview (will land here after the PR opens a preview)
• Anchor scroll behavior on /docs (sidebar links jump correctly; scroll-spy follow-up tracked separately as SQLR-29)

Vercel deploy

Point Vercel at web/ as the Root Directory. Framework preset auto-detects Next.js. No environment variables required.

Follow-ups (already filed in marvinapp)

• SQLR-29 Add scroll-spy to /docs sidebar nav
• SQLR-30 Wire web/ build + lint into CI (paths-filtered job)
• SQLR-31 Track Next.js / postcss transitive advisory in web/

Diff scope

$ git diff --stat origin/main..HEAD
 CLAUDE.md             |    1 +
 README.md             |    2 ++
 docs/_index.md        |    2 ++
 docs/roadmap.md       |   87 +++++++-
 docs/supported-sql.md |   28 ++-
 web/{...}             | 10832 +++++++++++++++++++++ (33 new files)

🤖 Generated with Claude Code